home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / GeomReq.3 < prev    next >
Text File  |  1994-09-20  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. Tk_GeometryRequest(3) Tk Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_GeometryRequest, Tk_SetInternalBorder -  specify  desired
  12.      geometry or internal border for a window
  13.  
  14. SYNOPSIS
  15.      #include <tk.h>
  16.  
  17.      Tk_GeometryRequest(_t_k_w_i_n, _r_e_q_W_i_d_t_h, _r_e_q_H_e_i_g_h_t)
  18.  
  19.      Tk_SetInternalBorder(_t_k_w_i_n, _w_i_d_t_h)
  20.  
  21. ARGUMENTS
  22.      Tk_Window    _t_k_w_i_n        (in)      Window     for     which
  23.                                          geometry     is    being
  24.                                          requested.
  25.  
  26.      int          _r_e_q_W_i_d_t_h     (in)      Desired width for _t_k_w_i_n,
  27.                                          in pixel units.
  28.  
  29.      int          _r_e_q_H_e_i_g_h_t    (in)      Desired    height    for
  30.                                          _t_k_w_i_n, in pixel units.
  31.  
  32.      int          _w_i_d_t_h        (in)      Space   to   leave   for
  33.                                          internal    border   for
  34.                                          _t_k_w_i_n, in pixel units.
  35. _________________________________________________________________
  36.  
  37.  
  38. DESCRIPTION
  39.      Tk_GeometryRequest is called by widget code to indicate  its
  40.      preference  for  the dimensions of a particular window.  The
  41.      arguments to Tk_GeometryRequest are made  available  to  the
  42.      geometry  manager  for the window, which then decides on the
  43.      actual geometry for the window.  Although geometry  managers
  44.      generally     try    to    satisfy    requests    made    to
  45.      Tk_GeometryRequest, there is no  guarantee  that  this  will
  46.      always  be  possible.   Widget code should not assume that a
  47.      geometry request will be satisfied until it receives a  Con-
  48.      figureNotify  event  indicating that the geometry change has
  49.      occurred.  Widget code should  never  call  procedures  like
  50.      Tk_ResizeWindow   directly.    Instead,   it  should  invoke
  51.      Tk_GeometryRequest and leave the final geometry decisions to
  52.      the geometry manager.
  53.  
  54.      If _t_k_w_i_n is a top-level window, then the  geometry  informa-
  55.      tion will be passed to the window manager using the standard
  56.      ICCCM protocol.
  57.  
  58.      Tk_SetInternalBorder is called by widget  code  to  indicate
  59.      that the widget has an internal border.  This means that the
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Tk_GeometryRequest(3) Tk Library Procedures
  71.  
  72.  
  73.  
  74.      widget draws a decorative border inside the  window  instead
  75.      of  using  the standard X borders, which are external to the
  76.      window's area.  For example, internal borders  are  used  to
  77.      draw  3-D  effects.  _W_i_d_t_h specifies the width of the border
  78.      in pixels.  Geometry managers will use this  information  to
  79.      avoid  placing  any children of _t_k_w_i_n overlapping the outer-
  80.      most _w_i_d_t_h pixels of _t_k_w_i_n's area.
  81.  
  82.      The information specified in calls to Tk_GeometryRequest and
  83.      Tk_SetInternalBorder  can  be  retrieved  using  the  macros
  84.      Tk_ReqWidth, Tk_ReqHeight, and Tk_InternalBorderWidth.   See
  85.      the Tk_WindowId manual entry for details.
  86.  
  87.  
  88. KEYWORDS
  89.      geometry, request
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Tk                                                              2
  130.  
  131.  
  132.  
  133.